home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / seyon.1 < prev    next >
Text File  |  1995-07-25  |  69KB  |  1,387 lines

  1.  
  2.  
  3.  
  4.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           Seyon - X11 Telecommunications Package.
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           sssseeeeyyyyoooonnnn [-option ...] [-toolkit_option ...] [--
  14.           -emulator_option ...]
  15.  
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           _S_e_y_o_n is a complete full-featured telecommunications package
  19.           for the _X _W_i_n_d_o_w _S_y_s_t_e_m. Some of its features are:
  20.  
  21.  
  22.                * Dialing directory that supports an unlimited number
  23.                of entries. The directory is fully mouse-driven and
  24.                features call progress monitoring, dial timeout,
  25.                automatic redial, multi-number dialing, and circular
  26.                redial queue. Each item in the dialing directory can be
  27.                configured with its own baud rate, bit mask, and script
  28.                file.  The dialing directory uses a plain-text phone
  29.                book that can be edited from withen Seyon. Seyon also
  30.                supports manual dialing.
  31.  
  32.                * Terminal emulation window supporting DEC VT02,
  33.                Tektronix 4014, and ANSI. Seyon delegates its terminal
  34.                emulation to xterm, so all the familiar xterm functions
  35.                such as the scroll-back buffer, cut-and-paste utility,
  36.                and visual bell are availabe through Seyon's terminal
  37.                emulation window. Using xterm also means that Seyon has
  38.                a more complete emulation of VT102 than other any Unix
  39.                or DOS telecommunications program. Other terminal
  40.                emulation programs can also be used with Seyon to suit
  41.                the user's need; for example, color xterm can be used
  42.                to provide emulation for color ANSI (popular on many
  43.                BBS systems), and xvt can be used if memory is a bit
  44.                tight.
  45.  
  46.                * Script language to automate tedious tasks such as
  47.                logging into remote hosts. Seyon's script interpreter
  48.                uses plain-text files and has a syntax similar to that
  49.                of sh, with a few extra addtions. It supports many
  50.                familiar statements such as conditional branching by
  51.                _i_f-_e_l_s_e and looping by _g_o_t_o. Scripts may be assigned to
  52.                items in the dialing directory for automatic execution
  53.                after a connection is made.
  54.  
  55.                * Unlimited number of slots for external file transfer
  56.                protocols.  Protocols are activated from a mouse-driven
  57.                transfer console that uses a plain-text file, editable
  58.                from withen Seyon, for protocol configuration. Seyon
  59.                prompts the user for filenames only if the chosen
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 7/3/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  71.  
  72.  
  73.  
  74.                protocol requires filenames or if the transfer
  75.                operation is an upload, for which Seyon also accepts
  76.                wildcards. Multiple download directories can be
  77.                specified for the different transfer slots.
  78.  
  79.                * Support for Zmodem auto-download. Seyon detects
  80.                incoming Zmodem signature and automatically activates a
  81.                user-specified zmodem protocol to receive incoming
  82.                files. Zmodem transfers can thus be completely
  83.                automatic and require no user intervention.
  84.  
  85.                * Translation modes. Seyon can perfrom useful
  86.                trasnlations on the user's input. From example, Seyon
  87.                can translate backspace to delete (useful on may Unix
  88.                systems), newline to carriage return (useful on many
  89.                BBS hosts), and my favorite, meta key tranlation: to
  90.                send keys pressed while the meta (ALT) key is held down
  91.                as an escape (ESC) followed by the key press. The
  92.                latter mode simulates the meta key on hosts that do not
  93.                support 8-bit-clean connections and makes possible the
  94.                use of the meta key in programs like Emacs on such
  95.                hosts.
  96.  
  97.                * Other features: interactive setting of program
  98.                parameters, on-line help, software (XONN/XOFF) and
  99.                hardware (RTS/CTS) flow control, session capture to a
  100.                file, and temporary running of a local shell in the
  101.                terminal emulation window.
  102.  
  103.  
  104.           Seyon is intended to be both simple and extensively
  105.           configurable.  Almost every aspect of Seyon can be
  106.           configured via the resources to suit the user's taste.
  107.  
  108.  
  109.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  110.           Besides the toolkit options, Seyon recognizes the following
  111.           command-line switches:
  112.  
  113.  
  114.           ----mmmmooooddddeeeemmmmssss <_d_e_v_i_c_e-_l_i_s_t>
  115.                Overrides the resource _m_o_d_e_m_s. Refer to the description
  116.                of that resource below.  Unlike the resource, however,
  117.                the list here has to be quoted if it consists of more
  118.                than one entry.
  119.  
  120.           ----eeeemmmmuuuullllaaaattttoooorrrr <_t_e_r_m_i_n_a_l-_e_m_u_l_a_t_i_o_n-_p_r_o_g_r_a_m>
  121.                Instructs Seyon to use the specified program as the
  122.                terminal emulator.  If Seyon fails to execute that
  123.                program, it will fall back to xterm. If this option is
  124.                not given, Seyon will try to use seyon-emu, which
  125.                should be a link to your favorite terminal emulation
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 7/3/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  137.  
  138.  
  139.  
  140.                program. Seyon will fall back to xterm in this case as
  141.                well if it fails to execute seyon-emu.
  142.  
  143.           --------   This switch instructs Seyon to pass the rest of the
  144.                command-line to the terminal emulation program. All
  145.                options following this switch will be passed blindly to
  146.                the emulator. This switch cannot be combined with
  147.                -noemulator.
  148.  
  149.           ----nnnnooooddddeeeeffffaaaarrrrggggssss
  150.                Seyon usually invokes the terminal emulation program
  151.                with some options to set the application name and
  152.                window and icon titles (those are -name Seyon -T "Seyon
  153.                Terminal Emulator" -n Terminal). If this switch is
  154.                given, Seyon will not pass those options to the
  155.                emulator.  This is to accommodate terminal emulation
  156.                programs that use a different command-line syntax than
  157.                xterm -- like xvt, cmdtool, shelltool, ..etc. You can
  158.                use the '--' switch to pass your own options to the
  159.                emulator.
  160.  
  161.           ----nnnnooooeeeemmmmuuuullllaaaattttoooorrrr
  162.                This option is valid only if Seyon is invoked from
  163.                withen a terminal emulation program in the foreground
  164.                of an interactive shell session.  If given, Seyon will
  165.                not launch a new terminal emulator, but will use the
  166.                existing one instead. You cannot use the '--' switch if
  167.                this option is given.
  168.  
  169.           ----ssssccccrrrriiiipppptttt <_s_c_r_i_p_t-_f_i_l_e>
  170.                Causes Seyon to automatically executes the specified
  171.                script after the startup script is run. The specified
  172.                script file will be looked for according to the rule
  173.                mentioned under the description of the resource
  174.                _s_c_r_i_p_t_D_i_r_e_c_t_o_r_y below.
  175.  
  176.           ----eeeennnnttttrrrriiiieeeessss <_e_n_t_r_i_e_s-_l_i_s_t>
  177.                Overrides the resource _d_e_f_a_u_l_t_P_h_o_n_e_E_n_t_r_i_e_s. Refer to
  178.                the description of that resource below. Unlike the
  179.                resource, however, the list here has to be quoted if it
  180.                consists of more than one entry.
  181.  
  182.           ----ddddiiiiaaaallll, ----nnnnooooddddiiiiaaaallll
  183.                Overrides the resource _d_i_a_l_A_u_t_o_S_t_a_r_t and sets it to
  184.                'on' and If both -_d_i_a_l and -_n_o_d_i_a_l are specified on the
  185.                command-line, the override value will be set according
  186.                to the last of the two on the command-line.
  187.  
  188.  
  189.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  190.           Besides the toolkit resources, Seyon defines the following
  191.           proprietry resources:
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 7/3/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  203.  
  204.  
  205.  
  206.           aaaauuuuttttooooZZZZmmmmooooddddeeeemmmm (_b_o_o_l_e_a_n)
  207.                Specifies whether Seyon is to look for Zmodem auto-
  208.                download signature.  If enabled, Seyon will detect
  209.                incoming Zmodem signature and execute the action given
  210.                by the resource autoZmodemAction (typically to start a
  211.                local rz). Otherwise, Zmodem signature will be ignored.
  212.                _D_e_f_a_u_l_t _v_a_l_u_e: _o_n
  213.  
  214.           aaaauuuuttttooooZZZZmmmmooooddddeeeemmmmAAAAccccttttiiiioooonnnn (_s_t_r_i_n_g)
  215.                Specifies a simple or compound action that will be
  216.                executed when Zmodem auto-download signature is
  217.                detected. This action will be executed only if the
  218.                resource autoZmodem is enabled (see above). Refer to
  219.                the section entitled _S_e_Q_u_i_c_k_K_e_y_s for a description of
  220.                available actions.  _D_e_f_a_u_l_t _v_a_l_u_e: _S_h_e_l_l_C_o_m_m_a_n_d($_r_z);
  221.  
  222.           bbbbaaaacccckkkkssssppppaaaacccceeeeTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnn (_b_o_o_l_e_a_n)
  223.                Whether to translate user's backspace to delete. When
  224.                the remote host is a Unix system, it's better to set
  225.                this to _o_n, since many Unix systems are not happy with
  226.                backspace.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  227.  
  228.           ccccaaaappppttttuuuurrrreeeeFFFFiiiilllleeee (_s_t_r_i_n_g)
  229.                The name of capture file. Seyon will write session
  230.                captures to this file when capture is enabled. This
  231.                file will be placed in Seyon's default directory. The
  232.                capture file will not be overwritten by successive
  233.                capture sessions. Seyon will merely apped new capture
  234.                to its end. _D_e_f_a_u_l_t _v_a_l_u_e: _c_a_p_t_u_r_e
  235.  
  236.           ccccoooonnnnnnnneeeeccccttttSSSSttttrrrriiiinnnngggg (_s_t_r_i_n_g)
  237.                The modem connect string. This the string response the
  238.                modem gives when a connection is made after dialing.
  239.                _D_e_f_a_u_l_t _v_a_l_u_e: _C_O_N_N_E_C_T
  240.  
  241.           ddddeeeeffffaaaauuuullllttttBBBBiiiittttssss (_i_n_t)
  242.                The default number of bits (character size). Seyon will
  243.                set the number of bits to this value on startup and
  244.                will use it for items in the dialing directory for
  245.                which no such parameter is given. Valid values are 5,
  246.                6, 7, and 8.  _D_e_f_a_u_l_t _v_a_l_u_e: _8
  247.  
  248.           ddddeeeeffffaaaauuuullllttttBBBBPPPPSSSS (_s_t_r_i_n_g)
  249.                The default baud rate. Seyon will set the baud rate to
  250.                this value on startup and will use it for items in the
  251.                dialing directory for which no baud rate is given.
  252.                _D_e_f_a_u_l_t _v_a_l_u_e: _9_6_0_0
  253.  
  254.           ddddeeeeffffaaaauuuullllttttDDDDiiiirrrreeeeccccttttoooorrrryyyy (_s_t_r_i_n_g)
  255.                Seyon's default directory. When looking for its files,
  256.                Seyon will first try this default directory, then the
  257.                current directory. Seyon will also put the capture file
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 7/3/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  269.  
  270.  
  271.  
  272.                in this directory.  _D_e_f_a_u_l_t _v_a_l_u_e: ~/._s_e_y_o_n
  273.  
  274.           ddddeeeeffffaaaauuuullllttttPPPPaaaarrrriiiittttyyyy (_i_n_t)
  275.                The default parity. Seyon will set the parity to this
  276.                value on startup and will use it for items in the
  277.                dialing directory for which no such parameter is given.
  278.                Valid values are 0 (no parity), 1 (odd parity), and 2
  279.                (even parity).  _D_e_f_a_u_l_t _v_a_l_u_e: _0
  280.  
  281.           ddddeeeeffffaaaauuuullllttttPPPPhhhhoooonnnneeeeEEEEnnnnttttrrrriiiieeeessss (_i_n_t _a_r_r_a_y)
  282.                This resource specifies a list of numbers corresponding
  283.                to the order the entries in the dialing directory
  284.                appear at. Seyon will highlight (select) those entries
  285.                on startup and whenever you click ``Default'' from the
  286.                dialing directory. This is useful if there is a set of
  287.                entries that you most frequesntly dial that want to be
  288.                highlghted automatically instead of doing that every
  289.                time by hand. You can override this resource by the
  290.                -_e_n_t_r_i_e_s command-line switch.  Unlike the command-line
  291.                switch, however, the list here should not be quoted.
  292.                Phonebook entries numbering starts at one.  _N_o _d_e_f_a_u_l_t
  293.                _v_a_l_u_e.
  294.  
  295.           ddddeeeeffffaaaauuuullllttttSSSSttttooooppppBBBBiiiittttssss (_i_n_t)
  296.                The default number of stop bits. Seyon will set the
  297.                number of stop bits to this value on startup and will
  298.                use it for items in the dialing directory for which no
  299.                such parameter is given. Valid values are 1 and 2.
  300.                _D_e_f_a_u_l_t _v_a_l_u_e: _1
  301.  
  302.           ddddiiiiaaaallllAAAAuuuuttttooooSSSSttttaaaarrrrtttt (_b_o_o_l_e_a_n)
  303.                This resource specifies that Seyon should start dialing
  304.                the entries specified by the resource
  305.                _d_e_f_a_u_l_t_P_h_o_n_e_E_n_t_r_i_e_s (or its override command-line
  306.                switch) on startup. Seyon will commence dialing those
  307.                entries after executing the startup script and any
  308.                script specified at the command line. A more convenient
  309.                way of automatic dialing on startup is to use the
  310.                override command-line switch -_d_i_a_l, which overrides
  311.                this resource and enables. If the resource is enabled,
  312.                it can be disabled at the command line by the override
  313.                switch -_n_o_d_i_a_l. Refer to the description of these
  314.                switches above.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  315.  
  316.           ddddiiiiaaaallllCCCCaaaannnncccceeeellllSSSSttttrrrriiiinnnngggg (_s_t_r_i_n_g)
  317.                The string Seyon sends to the modem to cancel dialing
  318.                while in progress.  _D_e_f_a_u_l_t _v_a_l_u_e: ^_M
  319.  
  320.           ddddiiiiaaaallllDDDDeeeellllaaaayyyy (_i_n_t)
  321.                How long in seconds Seyon should wait after no
  322.                connection is made withen _d_i_a_l_T_i_m_e_O_u_t before ciculating
  323.                to the next number.  _D_e_f_a_u_l_t _v_a_l_u_e: _1_0
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 7/3/94)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  335.  
  336.  
  337.  
  338.           ddddiiiiaaaallllDDDDiiiirrrrFFFFoooorrrrmmmmaaaatttt (_s_t_r_i_n_g)
  339.                This is a format string that specifies the layout of
  340.                the dialing direcotry. The default is '%-15s %-15s %6s
  341.                %1c%1c%1c %1c%1c %s' (no quotes).  Briefly: the fields
  342.                represent the host name, number, the baud rate, bits,
  343.                parity, stop bits, whether there is a custom prefix,
  344.                suffix, and the script name. You can understand more
  345.                what each field refers to by comparing with dialing
  346.                directory, fields that use the current setting (via the
  347.                keyword CURRENT) are designated by a question mark.
  348.                Notice that you cannot change the order the items in
  349.                the dialing directory appear at, only the format. For
  350.                example, if the numbers you call are all 7-digits, your
  351.                host names are short, you never use baud rates above
  352.                9600, and you like dashes between the baud rate, bits,
  353.                parity, and stop bits fields, then you may prefer to
  354.                use the format string '%-10s %-8s %5s-%1c-%1c-%1c
  355.                %1c%1c %s', which would be narrower than the default
  356.                format.  _D_e_f_a_u_l_t _v_a_l_u_e: %-_1_5_s %-_1_5_s %_6_s %_1_c%_1_c%_1_c
  357.  
  358.           ddddiiiiaaaallllPPPPrrrreeeeffffiiiixxxx (_s_t_r_i_n_g)
  359.                The string Seyon sends to the modem before the phone
  360.                number. To use pulse dialing, set this resource to .IR
  361.                ATDP .  _D_e_f_a_u_l_t _v_a_l_u_e: _A_T_D_T
  362.  
  363.           ddddiiiiaaaallllRRRReeeeppppeeeeaaaatttt (_i_n_t)
  364.                How many times Seyon should try dialing a number. Seyon
  365.                will give up on dialing a number if no connection is
  366.                made after this many tries.  _D_e_f_a_u_l_t _v_a_l_u_e: _5
  367.  
  368.           ddddiiiiaaaallllSSSSuuuuffffffffiiiixxxx (_s_t_r_i_n_g)
  369.                The string Seyon sends to the modem after the phone
  370.                number. This string has to contain a carraige return or
  371.                the number will never get sent to the mode.  _D_e_f_a_u_l_t
  372.                _v_a_l_u_e: ^_M
  373.  
  374.           ddddiiiiaaaallllTTTTiiiimmmmeeeeOOOOuuuutttt (_i_n_t)
  375.                How long in seconds Seyon should wait for a connection
  376.                to made after dialing is complete. Seyon will cancel
  377.                the dialing if no connection is made withen this
  378.                period.  _D_e_f_a_u_l_t _v_a_l_u_e: _4_5
  379.  
  380.           eeeexxxxiiiittttCCCCoooonnnnffffiiiirrrrmmmm (_b_o_o_l_e_a_n)
  381.                Whether Seyon should prompt for hanguping up before
  382.                exiting. If off-line and the resource ignoreModemDCD is
  383.                set to 'off', Seyon will not prompt for hanging up upon
  384.                exiting even if this resource is set to _D_e_f_a_u_l_t _v_a_l_u_e:
  385.                _o_n
  386.  
  387.           ffffuuuunnnnMMMMeeeessssssssaaaaggggeeeessss (_s_t_r_i_n_g _a_r_r_a_y)
  388.                The fun messages to be displayed when Seyon has no
  389.                other important information to show. This should be a
  390.  
  391.  
  392.  
  393.      Page 6                                           (printed 7/3/94)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  401.  
  402.  
  403.  
  404.                list of double-quoted [funny] sentences.  _D_e_f_a_u_l_t
  405.                _v_a_l_u_e: _v_a_r_i_e_s, _v_e_r_s_i_o_n-_d_e_p_e_n_d_e_n_t
  406.  
  407.           ffffuuuunnnnMMMMeeeessssssssaaaaggggeeeessssIIIInnnntttteeeerrrrvvvvaaaallll (_i_n_t)
  408.                The temporal interval in seconds between successive fun
  409.                messages.  _D_e_f_a_u_l_t _v_a_l_u_e: _1_5
  410.  
  411.           iiiiddddlllleeeeGGGGuuuuaaaarrrrdddd (_b_o_o_l_e_a_n)
  412.                If set to on, Seyon will send a string to the remote
  413.                host whenever the terminal session is idle (no keyboard
  414.                input) for a given amount of time. The resources
  415.                _i_d_l_e_G_u_a_r_d_I_n_t_e_r_v_a_l and _i_d_l_e_G_u_a_r_d_S_t_r_i_n_g specify the above
  416.                time interval and the string to be sent to the remote
  417.                host when idle. It is useful to enable this features to
  418.                keep the session alive when one is away from the
  419.                computer for a while (e.g.  to prevent auto-logout).
  420.                _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  421.  
  422.           iiiiddddlllleeeeGGGGuuuuaaaarrrrddddIIIInnnntttteeeerrrrvvvvaaaallll (_i_n_t)
  423.                The amount of time in seconds Seyon is to consider the
  424.                session idle when there is no keyboard activity at the
  425.                terminal for that long.  Seyon will send a string to
  426.                the remote host every such interval as long as the
  427.                session is idle.  _D_e_f_a_u_l_t _v_a_l_u_e: _3_0_0
  428.  
  429.           iiiiddddlllleeeeGGGGuuuuaaaarrrrddddSSSSttttrrrriiiinnnngggg (_s_t_r_i_n_g)
  430.                The string to be sent to the remote host when the
  431.                session is idle.  This string will be sent at a regular
  432.                interval as long as the sesiion remains idle. Note that
  433.                the current translations will be used in sending this
  434.                string; for example, if backspaceTranslation is
  435.                enabled, then the default string <Space><BS> will be
  436.                sent as <Space><DEL>.  _D_e_f_a_u_l_t _v_a_l_u_e: \_s^_H (space then
  437.                backspace)
  438.  
  439.           iiiiggggnnnnoooorrrreeeeMMMMooooddddeeeemmmmDDDDCCCCDDDD (_b_o_o_l_e_a_n)
  440.                If this resource is set to 'on', the modem DCD (Data
  441.                Carrier Detect) status will be ignored. Some of the
  442.                consequences of setting this to 'on' is that Seyon will
  443.                always prompt for hangup (if the resource _e_x_i_t_C_o_n_f_i_r_m
  444.                is set to 'on') even if the modem DCD status indicates
  445.                that it is off-line, and dialing will be attempted even
  446.                if the modem DCD status indicates that it is on-line.
  447.                It is highly recommended that you keep this set to
  448.                'off' unless your modem does not honor the DCD line.
  449.                Consult your modem's manual for more details.  _D_e_f_a_u_l_t
  450.                _v_a_l_u_e: _o_f_f
  451.  
  452.           hhhhaaaannnngggguuuuppppBBBBeeeeffffoooorrrreeeeDDDDiiiiaaaallll (_b_o_o_l_e_a_n)
  453.                When set to _o_n, Seyon will hangup the line (if
  454.                connected) before dialing the phone number. Otherwise,
  455.                the number will be dialed without hanging up, and it is
  456.  
  457.  
  458.  
  459.      Page 7                                           (printed 7/3/94)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  467.  
  468.  
  469.  
  470.                the user's responsibility to ensure that the line is
  471.                clear (no connection) when dialing.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_n
  472.  
  473.           hhhhaaaannnngggguuuuppppCCCCoooonnnnffffiiiirrrrmmmm (_b_o_o_l_e_a_n)
  474.                Whether Seyon should ask for confirmation before
  475.                hanging up the phone _D_e_f_a_u_l_t _v_a_l_u_e: _o_n
  476.  
  477.           hhhhaaaannnngggguuuuppppVVVViiiiaaaaDDDDTTTTRRRR (_b_o_o_l_e_a_n)
  478.                When enabled, Seyon will hangup up the modem by
  479.                dropping DTR. This is much quicker than hanging up by
  480.                sending a Hayes-like hangup string to the modem and
  481.                waiting to allow for escape guard time. However, some
  482.                modems and serial drivers choke on dropping DTR and
  483.                others just don't hangup when DTR is dropped, so in
  484.                these cases it should be disabled.  If disabled, Seyon
  485.                will hangup the modem by sending the string specified
  486.                by the resource modemAttentionString, followed by that
  487.                specified by the resource modemHangupString.  _D_e_f_a_u_l_t
  488.                _v_a_l_u_e: _o_f_f
  489.  
  490.           mmmmeeeettttaaaaKKKKeeeeyyyyTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnn (_b_o_o_l_e_a_n)
  491.                Whether to transmit keys pressed while the meta (ALT)
  492.                key is held down as an escape (ESC) followed by the key
  493.                press. Most hosts do not support 8-bit sessions, and
  494.                hence do not recognize the meta key.  Therefore, this
  495.                translation mode has to be enabled when connected to
  496.                such hosts to take advantage of the meta key in
  497.                programs that make use of it like Emacs.  _D_e_f_a_u_l_t
  498.                _v_a_l_u_e: _o_n
  499.  
  500.           mmmmooooddddeeeemmmmAAAAtttttttteeeennnnttttiiiioooonnnnSSSSttttrrrriiiinnnngggg (_s_t_r_i_n_g)
  501.                The string to send to the modem to get its attention
  502.                (switch to command mode). This string will be sent to
  503.                the modem before the hangup string when hangupViaDTR is
  504.                disabled.  _D_e_f_a_u_l_t _v_a_l_u_e: +++
  505.  
  506.           mmmmooooddddeeeemmmmHHHHaaaannnngggguuuuppppSSSSttttrrrriiiinnnngggg (_s_t_r_i_n_g)
  507.                The hangup string to send to the modem when
  508.                hangupViaDTR is disabled.  Default value: ATH^M
  509.  
  510.           mmmmooooddddeeeemmmmssss (_s_t_r_i_n_g)
  511.                A list of modem devies to use. Seyon will try modems in
  512.                this list one after the other until it finds an
  513.                available modem or the list is exhausted. _N_o _d_e_f_a_u_l_t
  514.                _v_a_l_u_e.
  515.  
  516.           mmmmooooddddeeeemmmmSSSSttttaaaattttuuuussssIIIInnnntttteeeerrrrvvvvaaaallll (_i_n_t)
  517.                This resource controls the amount of time (in seconds)
  518.                between updates to the modem status toggles (including
  519.                the clock). The default is five seconds, but you can
  520.                set it to one second (or any other number) if you want
  521.                the toggles to be updated more frequently. Even if you
  522.  
  523.  
  524.  
  525.      Page 8                                           (printed 7/3/94)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  533.  
  534.  
  535.  
  536.                set this to a large number, Seyon is intellegent enough
  537.                to update the toggles after each connect or hangup.
  538.                _D_e_f_a_u_l_t _v_a_l_u_e: _5
  539.  
  540.           mmmmooooddddeeeemmmmVVVVMMMMiiiinnnn (_i_n_t)
  541.                This resource specifies the minimum number of
  542.                characters that should be in the buffer before the read
  543.                process is satified. The read process will wait until
  544.                that number of incoming characters is in the buffer or
  545.                0.1 second has elapsed between the receiption of two
  546.                characters before displaying the data in the buffer.
  547.                This results in the data being displayed in chunks and
  548.                speeds up the terminal display. The speedup would be
  549.                most noticeable on slow machnes with fast modems.
  550.  
  551.                Leave this resource at its default (1) or set it at a
  552.                low value (6) if you have a slow modem (e.g. 2400bps).
  553.                Otherwise you might set it to the maximum value, which
  554.                is platform-dependent but generally 255. If you set it
  555.                to any number greater than the maximum value, it will
  556.                be truncated to the maximum value.  _D_e_f_a_u_l_t _v_a_l_u_e: _1
  557.  
  558.           nnnneeeewwwwlllliiiinnnneeeeTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnn (_s_t_r_i_n_g)
  559.                When the Enter key is pressed, newline character (\n)
  560.                is generated.  This resource determines what to
  561.                translate this character to. Three modes are possible:
  562.                no translation (newline), carriage return (\r), and
  563.                carriage return / line feed. Unix systems usually
  564.                expect newline or carrage return, DOS systems expect
  565.                carraige return or carriage return / line feed. The
  566.                three keywords corresponding to the above modes are _n_l,
  567.                _c_r, and _c_r/_l_f.  _D_e_f_a_u_l_t _v_a_l_u_e: _c_r
  568.  
  569.           nnnnooooCCCCoooonnnnnnnneeeeccccttttSSSSttttrrrriiiinnnnggggXXXX [_X = _1-_4] (_s_t_r_i_n_g)
  570.                The response strings given by the modem when connection
  571.                fails. _D_e_f_a_u_l_t _v_a_l_u_e_s: _N_O _C_A_R_R_I_E_R, _N_O _D_I_A_L_T_O_N_E, _B_U_S_Y,
  572.                (respectively)
  573.  
  574.           pppphhhhoooonnnneeeelllliiiissssttttFFFFiiiilllleeee (_s_t_r_i_n_g)
  575.                The name of the phone list (dialing directory) file.
  576.                See the included example to learn how this file should
  577.                be formatted.  _D_e_f_a_u_l_t _v_a_l_u_e: _p_h_o_n_e_l_i_s_t
  578.  
  579.           ppppoooossssttttCCCCoooonnnnnnnneeeeccccttttAAAAccccttttiiiioooonnnn (_s_t_r_i_n_g)
  580.                Specifies a simple or compound action that will be
  581.                executed after a connection to a remote host is made.
  582.                This action will be executed before running any script
  583.                attached to that host in the dialing directory. All
  584.                actions here have to be synchronous. Refer to the
  585.                section entitled _S_e_Q_u_i_c_k_K_e_y_s below for a description of
  586.                available actions.  _D_e_f_a_u_l_t _v_a_l_u_e: _B_e_e_p();
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                           (printed 7/3/94)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  599.  
  600.  
  601.  
  602.           pppprrrroooottttooooccccoooollllssssFFFFiiiilllleeee (_s_t_r_i_n_g)
  603.                The name of the protocols file. This file tells Seyon
  604.                what file transfer protocols are available. The user
  605.                will be promted with a list based on this file when
  606.                file transfer is to be initiated.  _D_e_f_a_u_l_t _v_a_l_u_e:
  607.                _p_r_o_t_o_c_o_l_s
  608.  
  609.           qqqquuuuiiiicccckkkkKKKKeeeeyyyyXXXX
  610.                Refer to the section entitled _S_e_Q_u_i_c_k_K_e_y_s below.
  611.  
  612.           rrrrttttssssccccttttssssFFFFlllloooowwwwCCCCoooonnnnttttrrrroooollll (_b_o_o_l_e_a_n)
  613.                Whether Seyon should turn on RTS/CTS hardware flow
  614.                control. Make sure the modem is set to use this as
  615.                well.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  616.  
  617.           ssssccccrrrriiiippppttttDDDDiiiirrrreeeeccccttttoooorrrryyyy (_s_t_r_i_n_g)
  618.                Seyon's script directory. When looking for scripts,
  619.                Seyon will first try this script directory, then the
  620.                current directory.  _D_e_f_a_u_l_t _v_a_l_u_e: _d_e_f_a_u_l_t_D_i_r_e_c_t_o_r_y
  621.  
  622.           sssshhhhoooowwwwFFFFuuuunnnnMMMMeeeessssssssaaaaggggeeeessss (_b_o_o_l_e_a_n)
  623.                Whether to display funny messages when Seyon has no
  624.                other important information to show. Seyon will display
  625.                those messages at an interval specified by the
  626.                _f_u_n_M_e_s_s_a_g_e_s_I_n_t_e_r_v_a_l resource when there is no other
  627.                important information to convey to the user. To disable
  628.                the display of fun messages, this resource has be set
  629.                to off.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_n
  630.  
  631.           ssssttttaaaarrrrttttuuuuppppAAAAccccttttiiiioooonnnn (_s_t_r_i_n_g)
  632.                Specifies a simple or compound action that will be
  633.                executed on startup. This action is executed prior to
  634.                running any script (in case the -script switch is
  635.                given) or dialing any entry of the dialing directory
  636.                (in case the -dial switch is given or the resource
  637.                dialAutoStart is enabled). You can make Seyon open the
  638.                dialing directory automatically on startup by using the
  639.                simple action ``OpenWidnow(Dial);'' as a constituent of
  640.                this complex action stack.  Note that running the
  641.                startup script is just a special case of this resource.
  642.                Refer to the section entitled _S_e_Q_u_i_c_k_K_e_y_s for a
  643.                description of available actions.  _D_e_f_a_u_l_t _v_a_l_u_e:
  644.                _R_u_n_S_c_r_i_p_t(_s_t_a_r_t_u_p);
  645.  
  646.           ssssttttaaaarrrrttttuuuuppppFFFFiiiilllleeee (_s_t_r_i_n_g)
  647.                Seyon's startup file. Seyon will execute all commands
  648.                in this file upon startup. This file can have any
  649.                commands acceptable as script commands. The most useful
  650.                command to put here is the _s_e_t command, to set the
  651.                various communications parameters.  _D_e_f_a_u_l_t _v_a_l_u_e:
  652.                _s_t_a_r_t_u_p
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                          (printed 7/3/94)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  665.  
  666.  
  667.  
  668.           ssssttttrrrriiiippppHHHHiiiigggghhhhBBBBiiiitttt (_b_o_o_l_e_a_n)
  669.                Whether to strip the high (eights) bit from incoming
  670.                characters. If set to on, the high bit of all incoming
  671.                characters will be stripped, which will make an 8-N-1
  672.                setting behave like 7-N-1, even though eight bits are
  673.                used for each character.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  674.  
  675.           xxxxoooonnnnxxxxooooffffffffFFFFlllloooowwwwCCCCoooonnnnttttrrrroooollll (_b_o_o_l_e_a_n)
  676.                Whether Seyon should turn on XON/XOFF software flow
  677.                control.  _D_e_f_a_u_l_t _v_a_l_u_e: _o_f_f
  678.  
  679.  
  680.      SSSSEEEEQQQQUUUUCCCCKKKKKKKKEEEEYYYYSSSS
  681.           Seyon allows the user to have custom buttons, called
  682.           SeQuickKeys (z quickies), to which actions can be attached.
  683.           SeQuickKeys provide a convenient way via which the user can
  684.           invoke frequently-used operations by a singe mouse click.
  685.           SeQuickKeys are specified through the resources quickKeyX,
  686.           where X is an integer corresponding to the order at which
  687.           that SeQuickKey is to appear on the command center.
  688.           Relevant subparts of that resource are _v_i_s_i_b_l_e, _a_c_t_i_o_n, and
  689.           _l_a_b_e_l. Here is an example:
  690.  
  691.                Seyon*quickKey3.visible: on
  692.                Seyon*quickKey3.action: FileTransfer(1,file); Beep();
  693.                Seyon*quickKey3.label: Upload
  694.  
  695.  
  696.           The first line specifies that SeQuickKey3 should be visible.
  697.           The second line specifies the action bound to the SeQuickKey
  698.           (in this case, a compound action), and the third line
  699.           specifies the label for that SeQuickKey's button. Other
  700.           subparts can also be specified in a similar fashion (e.g.
  701.           background, foreground, ..etc.)
  702.  
  703.           Actions can be either simple or compound. A compound action
  704.           consists of a stack of simple actions and can be used as
  705.           simple mini-script.  _E_x_a_m_p_l_e_s:
  706.  
  707.           o+ Set(idleGuard,on); DialEntries(Default);
  708.           o+ Echo("Uploading files..."); Transmit(rz); \
  709.                 FieTransfer(1,"*.ico $HOME/acct.wks"); Echo(Done);
  710.           o+ OpenWindow(Dial); DialEntries("2 5 6");
  711.           o+ Echo("Goodbye.."); Hangup(); Quit();
  712.           o+ Set(baud,9600); ManualDial("555-5555");
  713.           o+ Echo("Will upload..."); ShellCommand("$sz *.wks");
  714.           o+ Set(parity,0); RunScript(login.scr); Echo(Finished);
  715.  
  716.  
  717.           The following is a list of actions Seyon currently supports.
  718.           Asterisks designate asynchronoous actions. Brackets
  719.           designate optional arguments.
  720.  
  721.  
  722.  
  723.      Page 11                                          (printed 7/3/94)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  731.  
  732.  
  733.  
  734.           BBBBeeeeeeeepppp();
  735.                Rings the bell making a short beep.
  736.  
  737.  
  738.           CCCClllloooosssseeeeWWWWiiiinnnnddddoooowwww(_w_i_n_d_o_w [,...]);
  739.                Closes (dismisses) the given windows. Currenly the only
  740.                valid argument to this action is Dial, which
  741.                corresponds to the dialing idrectory window. _E_x_a_m_p_l_e:
  742.                CloseWindow(Dial);
  743.  
  744.  
  745.           DDDDiiiiaaaallllEEEEnnnnttttrrrriiiieeeessss(_e_n_t_r_i_e_s-_l_i_s_t);****
  746.                Dials entries in the dialing directory corresponding by
  747.                order to the given list. Entries will be dialed as if
  748.                the user had selected them on the dialing directory.
  749.                Entries will be dialed without opening the dialing
  750.                directory. You can use the action ``OpenWindow(Dial);''
  751.                and stack the two actions in a compound action if you
  752.                want the dialing directory to be opened.
  753.  
  754.                The list must be quoted if it consists of more than one
  755.                entry, and entries should be separated by white space,
  756.                not commas.  If the list consists of just the word
  757.                ``Default'', then the entries given by the resource
  758.                defaultPhoneEntries will be dialed, refer to the
  759.                description of that resource for more details.
  760.  
  761.                The most common use of this action is attach
  762.                frequesntly-dialed hosts to SeQuickKeys, making dialing
  763.                those hosts a one-click operation. If this action is
  764.                not the last in a compound action stack, actions
  765.                specified by the resource postConnectAction may not
  766.                work properly.  _E_x_a_m_p_l_e_s: DialEntries(2);
  767.                DialEntries("2 4 5"); DialEntries(Default);
  768.  
  769.  
  770.           DDDDiiiivvvveeeerrrrttttFFFFiiiilllleeee([_f_i_l_e]);****
  771.                Sends the given file to the remote host as a text
  772.                upload. If the optional argument ``file'' is not
  773.                specified, Seyon will pop up a dialog box asking for
  774.                the file name. In the latter case this action is
  775.                similar to clicking Divert from the Misc window.
  776.                _E_x_a_m_p_l_e_s: DivertFile("/tmp/acct.wks"); DivertFile();
  777.  
  778.  
  779.           EEEEcccchhhhoooo([_s_t_r_i_n_g]);
  780.                Echos the given string to the terminal. Does not send
  781.                it to the modem (use Transmit for that). If the string
  782.                consists of more than one word, it must be quoted. Note
  783.                that unlike the shell command of the same name, this
  784.                command does not accepts the switch -n but always
  785.                appends newline to the string. If the argument is
  786.  
  787.  
  788.  
  789.      Page 12                                          (printed 7/3/94)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  797.  
  798.  
  799.  
  800.                omitted, an empty line will be echoed. _E_x_a_m_p_l_e_s:
  801.                Echo(Hello); Echo("Hello there"); Echo();
  802.  
  803.  
  804.           FFFFiiiilllleeeeTTTTrrrraaaannnnssssffffeeeerrrr(_e_n_t_r_y, [_f_i_l_e-_l_i_s_t]);****
  805.                Executes the transfer protocol corresponding by order
  806.                in the trasfer console (protocols file) to ``entry''.
  807.                If that protocol requires a file name and file-list is
  808.                omitted, Seyon will pop up a dialog box asking for the
  809.                file. Otherwise file-list will be passed to that
  810.                protocol. The list must be quotes if it consists of
  811.                more than one word and items in it should be separated
  812.                by white space. It can contain wild cards and shell
  813.                variables. _E_x_a_m_p_l_e_s: FileTransfer(1);
  814.                FileTransfer(2,acct.wks); FileTransfer(2,"*.wks
  815.                $HOME/acct.wks");
  816.  
  817.  
  818.           HHHHaaaannnngggguuuupppp();
  819.                Disconnects the line. Does not pop up a confirmation
  820.                box.
  821.  
  822.  
  823.           IIIIccccoooonnnniiiiffffyyyyWWWWiiiinnnnddddoooowwww(_w_i_n_d_o_w [,...]);
  824.                Iconifies the given windows. Valid arguments to this
  825.                action are Main, Dial, and Term, corresponding
  826.                respectively to the command center, dialing directory,
  827.                and terminal emulator windows. When the argument is
  828.                Term, this action will work only if the terminal
  829.                emulator sets the envirenment variable WINDOWID, like
  830.                xterm does. _E_x_a_m_p_l_e_s: IconifyWindow(Main,Dial,Term);
  831.                IconifyWindow(Dial);
  832.  
  833.  
  834.           MMMMaaaannnnuuuuaaaallllDDDDiiiiaaaallll([_n_u_m_b_e_r]);****
  835.                Dials a number as if the Manual button had been clicked
  836.                from the dialing directory. If ``number'' is specified,
  837.                it will be dialed directly and no dialog box will be
  838.                popped up asking for the number.  _E_x_a_m_p_l_e_s:
  839.                ManualDial(555-5555); ManualDial();
  840.  
  841.  
  842.           MMMMeeeessssssssaaaaggggeeee([_s_t_r_i_n_g]);
  843.                Echos the given string to the message box of Seyon's
  844.                command center (main window). If the string consists of
  845.                more than one word, it must be quoted. If the argument
  846.                is omitted, an empty line will be echoed.  _E_x_a_m_p_l_e_s:
  847.                Message(Hello); Message("Hello there"); Message();
  848.  
  849.  
  850.           OOOOppppeeeennnnWWWWiiiinnnnddddoooowwww(_w_i_n_d_o_w [,...]);
  851.                Opens each of the given windows by popping it if closed
  852.  
  853.  
  854.  
  855.      Page 13                                          (printed 7/3/94)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  863.  
  864.  
  865.  
  866.                or de-iconifying it if in an iconic state. Valid
  867.                arguments to this action are Main, Dial, and Term,
  868.                corresponding respectively to the command center,
  869.                dialing directory, and terminal emulator windows. When
  870.                the argument is Term, this action will work only if the
  871.                terminal emulator sets the envirenment variable
  872.                WINDOWID, like xterm does.  _E_x_a_m_p_l_e_s:
  873.                OpenWindow(Main,Dial,Term); OpenWindow(Dial);
  874.  
  875.  
  876.           QQQQuuuuiiiitttt();
  877.                Exits Seyon completely and returns to the shell. Does
  878.                not pop up a confirmation box.
  879.  
  880.  
  881.           RRRRuuuunnnnSSSSccccrrrriiiipppptttt([_s_c_r_i_p_t-_n_a_m_e]);****
  882.                Executes the script given by the file script-name. The
  883.                script will be executed as if the user had selected it
  884.                via the Script button. If script-name is omitted, a
  885.                dialog box will be popped up asking for the script
  886.                name. This is a very versatile action, as many remote
  887.                and local commands or series of commands can be
  888.                performed by attaching appropriate scripts to
  889.                SeQuickKeys. _E_x_a_m_p_l_e_s: RunScript(login.scr);
  890.                RunScript();
  891.  
  892.  
  893.           SSSSeeeetttt(_p_a_r_a_m_e_t_e_r, _v_a_l_u_e);
  894.                Sets the specified parameter to the given value. Can be
  895.                used to set the various communications parameters.
  896.                Available parameters are listed under the script
  897.                command ``set''.  _E_x_a_m_p_l_e_s: Set(baud,9600);
  898.                Set(parity,0); Set(idleGuard,off).
  899.  
  900.  
  901.           SSSShhhheeeellllllllCCCCoooommmmmmmmaaaannnndddd(_s_h_e_l_l-_c_o_m_m_a_n_d);****
  902.                Executes the given shell command via the user's shell
  903.                pointed to by the SHELL environment variable, or
  904.                /bin/sh if that environment variable is not set. Note
  905.                that the command must be quoted if it consists of more
  906.                than one word. If the first non-space letter of the
  907.                command is the character ``$'', then standard input and
  908.                standard output will be redirected to to the modem.
  909.                This action can be used to execute any external program
  910.                from withen Seyon. _E_x_a_m_p_l_e: ShellCommand(ls);
  911.                ShellCommand("$cd $HOME; sz -vv *.wks");
  912.  
  913.  
  914.           TTTTrrrraaaannnnssssmmmmiiiitttt(_s_t_r_i_n_g);
  915.                Transmits the given string to the remote host. The
  916.                string must be quoted if it consists of more than one
  917.                word. The string is transmitted as is (no case
  918.  
  919.  
  920.  
  921.      Page 14                                          (printed 7/3/94)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  929.  
  930.  
  931.  
  932.                conversions are performed). No newline character or
  933.                carriage return is appended to the string, use the
  934.                prefix characters for that (e.g. ^M, ^J). See the
  935.                discripttion of the script command ``transmit'' for
  936.                more details. _E_x_a_m_p_l_e: Transmit(ls^M); Transmit("ls
  937.                -CF^M");
  938.  
  939.  
  940.      SSSSCCCCRRRRIIIIPPPPTTTT LLLLAAAANNNNGGGGUUUUAAAAGGGGEEEE
  941.           Script files can automate some tedious tasks such as logging
  942.           into a system.  A script file is an ascii text file and may
  943.           be entered or edited using any standard text editor.
  944.  
  945.           The script file is read line by line.  Empty lines
  946.           (consisting of white space only) are ignored.  Comments are
  947.           lines whose first non-space character is a pound sign (#).
  948.  
  949.           The script processor reads each script line, ignoring
  950.           leading white space, into _w_o_r_d_s. A word is defined as
  951.           either:
  952.  
  953.  
  954.                o+ a sequence of characters delimited by white space, or
  955.                o+ a sequence of characters enclosed in single or double
  956.                quotes.
  957.  
  958.  
  959.           The first word of a script file is considered the _c_o_m_m_a_n_d
  960.           _w_o_r_d.  If the last character of the command word is a colon
  961.           (:), the line is considered to be a _l_a_b_e_l (the object of a
  962.           _g_o_t_o statement).  Otherwise, it is assumed to be a script
  963.           command and is interpreted as such. Command words are case
  964.           insensative.
  965.  
  966.           Some commands take one or more arguments. Each argument is
  967.           parsed as a single word as defined above.  If blanks are
  968.           required in an argument, the argument must be quoted using
  969.           single or double quotes.
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.         SSSSccccrrrriiiipppptttt CCCCoooommmmmmmmaaaannnndddd LLLLiiiisssstttt
  982.           Below is the description of all commands that may be used in
  983.           the Seyon script language:
  984.  
  985.  
  986.  
  987.      Page 15                                          (printed 7/3/94)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  995.  
  996.  
  997.  
  998.           ccccaaaappppttttuuuurrrreeee oooonnnn||||ooooffffffff (_c_u_r_r_e_n_t_l_y _m_a_y _n_o_t _w_o_r_k)
  999.                The command _c_a_p_t_u_r_e _o_n will enable capture. All
  1000.                characters received during _w_a_i_t_f_o_r processing will be
  1001.                appended to the capture file. The command _c_a_p_t_u_r_e _o_f_f
  1002.                will close the capture file.  This setting does not
  1003.                currently extend to terminal mode. This may be offered
  1004.                in a later release.
  1005.  
  1006.  
  1007.           ddddeeeebbbbuuuugggg oooonnnn||||ooooffffffff
  1008.                If the argument is _o_n, all subsequent command lines
  1009.                processed will be displayed on the local screen. The
  1010.                exception to this is lines containing a _t_r_a_n_s_m_i_t
  1011.                command. These lines will just print _T_R_A_N_S_M_I_T..., so
  1012.                that passwords, etc. can be protected. If the argument
  1013.                is _o_f_f, scripts will execute quietly (this is the
  1014.                default setting).
  1015.  
  1016.  
  1017.           ddddiiiiaaaallll <_n_u_m_b_e_r>
  1018.                Dial the specified number.  Seyon supports generic
  1019.                "Hayes" compatible modems for dialing.  Note that this
  1020.                command requires an actual phone number. The phonebook
  1021.                is not used for this function.
  1022.  
  1023.  
  1024.           eeeecccchhhhoooo <_s_t_r_i_n_g>
  1025.                Echos the given string to the terminal. Does not send
  1026.                it to the modem (use _t_r_a_n_s_m_i_t for that). If the string
  1027.                contains spaces, it must be quoted. Note that unlike
  1028.                the shell command of the same name, this command does
  1029.                not accepts the switch -n but always appends newline to
  1030.                the string.
  1031.  
  1032.  
  1033.           eeeexxxxiiiitttt Terminates the script file prior to the end of file.
  1034.                Returns to terminal mode.
  1035.  
  1036.  
  1037.           fffflllluuuusssshhhh
  1038.                Flushes the modem, i.e. discards data written to the
  1039.                modem but not transmitted and data received but not
  1040.                read.
  1041.  
  1042.  
  1043.           ggggoooottttoooo <_l_a_b_e_l>
  1044.                Goes to the specified label in the script file and
  1045.                continues execution from that point. The label may
  1046.                either precede or follow the actual _g_o_t_o statement. A
  1047.                label is any _c_o_m_m_a_n_d _w_o_r_d whose last character is a
  1048.                colon (:).
  1049.  
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                          (printed 7/3/94)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  1061.  
  1062.  
  1063.  
  1064.           hhhhaaaannnnuuuupppp
  1065.                Hangups up the line and disconnects from the remote
  1066.                host.
  1067.  
  1068.  
  1069.           iiiiffff, eeeellllsssseeee, eeeennnnddddiiiiffff
  1070.                _S_y_n_t_a_x:
  1071.                _i_f <condition>
  1072.                        <statements>
  1073.                [_e_l_s_e
  1074.                        <statements>]
  1075.                _e_n_d_i_f
  1076.  
  1077.                Conditionally executes statements based on specified
  1078.                condition. Seyon supports the following conditions:
  1079.  
  1080.  
  1081.                _w_a_i_t_f_o_r: true if the last _w_a_i_t_f_o_r command was
  1082.                successful.
  1083.                _l_i_n_k_e_d: true if this script was executed from the
  1084.                dialing directory.
  1085.  
  1086.                Conditions may be negated using the prefix _n_o_t or the
  1087.                character !:
  1088.  
  1089.  
  1090.                !_w_a_i_t_f_o_r: true If the last _w_a_i_t_f_o_r command timed out.
  1091.                _n_o_t _w_a_i_t_f_o_r: same as !_w_a_i_t_f_o_r above
  1092.  
  1093.                The _e_l_s_e and _e_n_d_i_f keywords must appear on their own
  1094.                lines. _I_f statements may not be nested.
  1095.  
  1096.  
  1097.           ppppaaaauuuusssseeee <_t_i_m_e>
  1098.                Suspends execution of the script for the specified
  1099.                number of seconds.  This is usually used for timing
  1100.                considerations; for example, waiting a couple of
  1101.                seconds after receiving the _c_o_n_n_e_c_t message and typing
  1102.                ^C to CompuServe.
  1103.  
  1104.  
  1105.           ppppuuuurrrrggggeeee
  1106.                Reads and discards all data coming from the modem for
  1107.                the duration of one second.
  1108.  
  1109.  
  1110.           qqqquuuuiiiitttt Terminates the script and exits the whole program
  1111.                (returns to the shell).
  1112.  
  1113.  
  1114.  
  1115.           rrrreeeeddddiiiiaaaallll
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                          (printed 7/3/94)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  1127.  
  1128.  
  1129.  
  1130.                Redials the last number dialed using the _d_i_a_l command.
  1131.  
  1132.  
  1133.           sssseeeennnndddd____bbbbrrrreeeeaaaakkkk
  1134.                Sends a BREAK signal to te remote host.
  1135.  
  1136.  
  1137.           sssseeeetttt <_p_a_r_a_m_e_t_e_r> <_v_a_l_u_e>
  1138.                Sets the specified parameter to the given value. Can be
  1139.                used to set the various communications parameters for
  1140.                each host. The follwoing is a list of the _s_e_t keywords
  1141.                that Seyon recognizes. Keywords marked with an asterisk
  1142.                set the current parameter only, not the default one.
  1143.                Refer to the corresponig resource (in parentheses
  1144.                below) for details of the function of each keyword.
  1145.  
  1146.  
  1147.  
  1148.                _b_a_u_d* (defaultBPS)
  1149.                _b_i_t_s* (defaultBits)
  1150.                _p_a_r_i_t_y* (defaultParity)
  1151.                _s_t_o_p_B_i_t_s* (defaultStopBits)
  1152.                _s_t_r_i_p_H_i_g_h_B_i_t (stripHighBit)
  1153.                _n_e_w_l_i_n_e_T_r_a_n_s_l_a_t_i_o_n (newlineTranslation)
  1154.                _d_e_l (backspaceTranslation)
  1155.                _m_e_t_a__t_r (metaKeyTranslation)
  1156.                _x_o_f_f (xonxoffFlowControl)
  1157.                _r_t_s_c_t_s (rtsctsFlowControl)
  1158.                _a_u_t_o_z_m (zmodemAutoDownload)
  1159.                _i_d_l_e_G_u_a_r_d (idleGuard)
  1160.  
  1161.                Boolean keywords accept _o_n or _o_f_f as their argument,
  1162.                other keywords accept the same arguments as the
  1163.                corresponding resources.
  1164.  
  1165.  
  1166.           sssshhhheeeellllllll <_s_h_e_l_l-_c_o_m_m_a_n_d>
  1167.                Executes the given shell command via the user's shell
  1168.                pointed to by the SHELL environment variable, or
  1169.                /bin/sh if the environment variable SHELL is not set.
  1170.                Note that the command must be quoted if it consists of
  1171.                more than one word. If the first non-space letter of
  1172.                the command is the character '$', then standard input
  1173.                and standard output will be redirected to to the modem.
  1174.                This command can be used to execute any external
  1175.                program from withen Seyon. _E_x_a_m_p_l_e: shell "cd /usr/dl;
  1176.                rz -vv".
  1177.  
  1178.  
  1179.           ttttrrrraaaannnnssssmmmmiiiitttt <_t_e_x_t>
  1180.                Transmits the specified text to the remote host. The
  1181.                text argument should be quoted (using single or double
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                          (printed 7/3/94)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  1193.  
  1194.  
  1195.  
  1196.                quotes) if there are spaces to be transmitted. The text
  1197.                is transmitted as is (no case conversions are
  1198.                performed).
  1199.  
  1200.                _P_r_e_f_i_x _c_h_a_r_a_c_t_e_r_s:
  1201.  
  1202.                ^ is the Control character prefix: the next character
  1203.                is made into a control character. For example, ^M is
  1204.                _c_a_r_r_i_a_g_e _r_e_t_u_r_n (0x0D) and ^J is _n_e_w_l_i_n_e (0x0A).
  1205.                \ is quote prefix: the next character is transmitted
  1206.                verbatim. For example, \^ would transmit a literal ^.
  1207.  
  1208.  
  1209.           ttttttttyyyy oooonnnn||||ooooffffffff
  1210.                This command specifies whether or not characters
  1211.                received from the modem will be displayed on the local
  1212.                terminal.  Since the only time that the script
  1213.                processor looks at the receive queue is during _w_a_i_t_f_o_r
  1214.                processing, the displays may look a bit erratic.  Use
  1215.                the _t_t_y _o_f_f command to disable local display of
  1216.                received characters during script processing.
  1217.  
  1218.  
  1219.           wwwwaaaaiiiittttffffoooorrrr <_t_e_x_t> [_t_i_m_e_o_u_t]
  1220.                Waits for the specified text to appear from the modem.
  1221.                The text argument should be quoted (using single or
  1222.                double quotes) if there are spaces to be transmitted.
  1223.  
  1224.                Special characters are interpreted the same as for
  1225.                _t_r_a_n_s_m_i_t.  If the timeout argument is specified, Seyon
  1226.                will wait that number of seconds for the string to
  1227.                appear.  If no timeout is given, Seyon defaults to 30
  1228.                seconds.
  1229.  
  1230.                During _w_a_i_t_f_o_r processing, characters received (up to
  1231.                and including the last character found in the text or
  1232.                in the timeout) can be captured to a disk file (if
  1233.                _c_a_p_t_u_r_e _o_n is specified), and/or displayed to the
  1234.                screen (if _t_t_y _o_n is specified).
  1235.  
  1236.  
  1237.           wwwwhhhheeeennnn [<_s_t_r_i_n_g-_t_o-_e_x_p_e_c_t> <_s_t_r_i_n_g-_t_o-_s_e_n_d>]
  1238.                Sends string-to-send whenever it encounters string-to-
  1239.                expect while waiting in a _w_a_i_t_f_o_r command, whatever the
  1240.                number if times string-to-expect is encountered.
  1241.  
  1242.                This is is useful if the order of prompts expected is
  1243.                not known before hand. For example, some BBS systems
  1244.                (notably PCBoard) change the prompts depeding on the
  1245.                time of call, and a complete script for such boards
  1246.                cannot be written using _w_a_i_t_f_o_r only.
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                          (printed 7/3/94)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  1259.  
  1260.  
  1261.  
  1262.                As many number of _w_h_e_n commands as desired can be
  1263.                specified. A _w_h_e_n command with no arguments clears all
  1264.                outstanding _w_h_e_n commands.  _w_a_i_t_f_o_r commands take
  1265.                precedence over _w_h_e_n commands if they expect the same
  1266.                string.
  1267.  
  1268.                A typical use of this command would be:
  1269.  
  1270.                        when "Continue?"       "y^M"
  1271.                        when "More?"           "n^M"
  1272.                        waitfor "BBS Command?"
  1273.                        when
  1274.  
  1275.                The above script keeps sending "y^M" to every
  1276.                Continue?" prompt and "n^M" to every "More?" prompt
  1277.                until the the string "BBS Command?" is encountered. The
  1278.                lasy _w_h_e_n clears all outstanding _w_h_e_n commands.
  1279.  
  1280.  
  1281.      FFFFIIIILLLLEEEESSSS
  1282.           The default Seyon files are _s_t_a_r_t_u_p, _p_h_o_n_e_l_i_s_t, and
  1283.           _p_r_o_t_o_c_o_l_s.  These have to be in the current directory,
  1284.           Seyon's default directory (~/._s_e_y_o_n), or the user's home
  1285.           directory. The default script directory is Seyon's default
  1286.           directory. All of these files and directories can be
  1287.           overridden by setting the appropriate resources. See the
  1288.           description of those resources as well as the description of
  1289.           the files above.
  1290.  
  1291.  
  1292.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1293.           xterm(1), resize(1)
  1294.  
  1295.  
  1296.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  1297.           Seyon is Copyright (c) 1992-1993 of Muhammad M. Saggaf.
  1298.           Seyon is not public domain. Permission is granted to use and
  1299.           distribute Seyon freely for any use and to sell it at any
  1300.           price without reference to the copyright owner provided that
  1301.           in all above cases Seyon is intact and is not made part of
  1302.           any program either in whole or in part and that this
  1303.           copyright notice is included with Seyon. Permission is also
  1304.           granted to modify the source as long as the modified source
  1305.           is not distributed.
  1306.  
  1307.  
  1308.      BBBBUUUUGGGGSSSS
  1309.           The script command 'set port' is not supported in this
  1310.           release. If the action DialEntries is not the last in a
  1311.           compound action stack, actions specified by the resource
  1312.           postConnectAction may not work properly.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                          (printed 7/3/94)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      SSSSEEEEYYYYOOOONNNN((((1111))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  SSSSEEEEYYYYOOOONNNN((((1111))))
  1325.  
  1326.  
  1327.  
  1328.           If Seyon is hung, it can be made to exit cleanly by killing
  1329.           its main process by signal 15 (SIGTERM) from another shell.
  1330.           Seyon's main process is the one that has the lowest PID
  1331.           (Process ID) number. For example, if ps shows:
  1332.  
  1333.                    1100 p0 S     0:04 seyon -noemulator
  1334.                    1101 p0 S     0:00 seyon -noemulator
  1335.                    1102 p0 S     0:38 seyon -noemulator
  1336.  
  1337.           Then ``kill -15 1100'' or ``kill 1100'' would cause Seyon
  1338.           clean up and exit gracefully.
  1339.  
  1340.  
  1341.      AAAAUUUUTTTTHHHHOOOORRRR
  1342.           Muhammad M. Saggaf, alsaggaf@mit.edu. Snail Mail: Muhammad
  1343.           Saggaf, Box 9863, Dhahran 31311, SAUDI ARABIA. I apologize
  1344.           that I may not be able to respond to all correspondence I
  1345.           receive.
  1346.  
  1347.           xcomm 2.2 was written by Eric Coe and Larry Gensch.
  1348.  
  1349.  
  1350.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTT
  1351.           David Boyce for helpuful suggestions, the Imake file, and
  1352.           patches for clean build under gcc -Wall; Joaquim Jorge for
  1353.           the lex/yacc parsing routines contributed by him; and the
  1354.           many people who sent me patches for various platforms: Fred
  1355.           Appleman (SVR4), atae@spva.dnet.nasa.gov (Ultrix), Alain
  1356.           Hebert (SVR3.2), Peter Davies (Sun Sparc), Eric Schmidt
  1357.           (Apollo), David Sanderson (AIX), Jonathan Bayer (Sun), Jeff
  1358.           Johnson (SVR4), Glenn Geers (SVR4-Esix), Tony Vincent-Sun-
  1359.           Vienna (Solaris), Bob Smith (SunOS 3.x and sgtty interface).
  1360.           (pardon me if I forgot to mention you). I'm also thankful to
  1361.           all the nice people who sent me suggestions or bug reports.
  1362.  
  1363.           The MultiList widget used in the dialing directory is
  1364.           written by the Free Widget Foundation. You can get it and
  1365.           other FWF widgets by ftp from a.cs.uiuc.edu.
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                          (printed 7/3/94)
  1384.  
  1385.  
  1386.  
  1387.